SUNO LYRIC TRANSCRIBER — CPANEL UPLOAD GUIDE
============================================

WHAT THIS PACKAGE NEEDS
-----------------------
Nothing has to be installed on the server. It does not need PHP, Node.js, a
database, or an OpenAI API key. It is a static website that runs Whisper in the
visitor's browser.

For the best results, use an HTTPS website and a current version of Chrome or
Edge. The first transcription downloads the Whisper Small English model, which
is a large download and can take several minutes. Later uses should be faster
because the browser normally caches it. The browser must have internet access
to download the transcription software and model.

SAFE CPANEL INSTALLATION (RECOMMENDED)
--------------------------------------
1. Sign in to your hosting account and open cPanel.
2. Open File Manager.
3. Open the public_html folder.
4. Create a new folder named:

      suno-lyrics

   Installing in a separate folder protects your existing home page.

5. Open public_html/suno-lyrics.
6. Click Upload, then upload the ZIP file supplied with this guide.
7. Return to File Manager, select the ZIP, and click Extract.
8. IMPORTANT: index.html must sit directly inside the suno-lyrics folder.

   Correct:
      public_html/suno-lyrics/index.html
      public_html/suno-lyrics/app.js
      public_html/suno-lyrics/whisper-worker.js
      public_html/suno-lyrics/styles.css

   Wrong (extra nested folder):
      public_html/suno-lyrics/Suno_Lyric_Transcriber_cPanel/index.html

   If you see the extra folder, open it, select all its contents, click Move,
   and move them to /public_html/suno-lyrics/.

9. You may delete the uploaded ZIP from the server after extraction.
10. Visit this address, replacing yourdomain.com with your real domain:

      https://yourdomain.com/suno-lyrics/

11. Test with one short MP3 or WAV first.

ADDING A LINK FROM YOUR EXISTING WEBSITE
----------------------------------------
Use the following address in your website menu or button:

    /suno-lyrics/

If you are editing HTML, the link can be:

    <a href="/suno-lyrics/">Suno Lyric Transcriber</a>

IMPORTANT NOTES
---------------
* The song is processed on the visitor's device; it is not uploaded to your
  cPanel server by this tool.
* Automatic transcription is a first draft. Singing, harmonies, stretched
  sounds, and background ad-libs can still be missed. Listen and correct the
  draft before submitting lyrics to a distributor.
* This version uses the English Whisper model.
* Supported uploads: MP3, WAV, M4A, MP4, MPEG, MPGA, and WebM, up to 25 MB.
* If an M4A or MP4 will not open, export the audio as MP3 or WAV and try again.
* Do not put these files directly into public_html unless you intend to replace
  your current website home page.

TROUBLESHOOTING
---------------
Blank page:
  Confirm index.html is directly inside public_html/suno-lyrics and refresh.

Model download or transcription fails:
  Use current Chrome or Edge, check the internet connection, disable strict
  content blockers for the page, then reload. Make sure the website uses HTTPS.

404 Not Found:
  Check that the folder is named suno-lyrics and that the URL ends with
  /suno-lyrics/.

Existing website disappeared:
  You may have extracted index.html directly into public_html. Restore your
  host's backup, then reinstall this package in public_html/suno-lyrics instead.
